Aviation API
22 Runway Sensor Condition Data
Sensors installed in the runway surface provide friction, water depth and temperature measurements every minute.
22.1 Latest for an Airport and Sensor
Request the latest 1 minute observation data for an airport and sensor. See tables below for supported airport (ICAO code) and associated sensors.
22.1.1 API Call:
GET /aviation/observations/airport/{ICAODesignator}/sensor/{sensor}/latest22.1.2 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| ICAODesignator | NZWN | A supported ICAO airport code (upper case). See table below for valid codes. This parameter is Mandatory. |
| sensor | NZWNH | The identifier for the Sensor (upper case). See table below for valid Sensor Identifiers. This parameter is Mandatory. |
22.1.3 Example:
This example would return the latest observations for Wellington Airport for runway sensor H.
GET /aviation/observations/airport/NZWN/sensor/NZWNH/latest22.1.4 API Response:
{
"version":"1.0",
"issue-time":"2019-05-20T00:32:02Z",
"path":"/aviation/observations/airport/NZWN/sensor/NZWNH/latest",
"response":[
{
"av:runway-sensor-id":"NZWNH",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:31:21Z",
"met:valid-at":"2019-05-20T00:30:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNH",
"observationTimestamp":"20190520003000",
"stationIdNumeric":"93965",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.7",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.6"
}
}
]
}22.2 Last n minutes or hours for a given Airport and Sensor
Request the last n hours or minutes of observation data for a given airport and sensor. See tables below for supported airport (ICAO code) and sensor identifiers.
22.2.1 API Call:
GET /aviation/observations/airport/{ICAODesignator}/sensor/{sensor}/last/{n}/{timeUnits}22.2.2 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| ICAODesignator | NZWN | A supported ICAO airport code (upper case). See table below for valid codes. This parameter is Mandatory. |
| sensor | NZWNG | The identifier for the Sensor (upper case). See table below for valid Sensor Identifiers. This parameter is Mandatory. |
| n | 10 | The duration in time units to return the data for. Valid values: up to 6 hours or 360 minutes. This parameter is Mandatory. |
| timeUnits | minutes | The time unit for the duration parameter (n). Valid values: hours or minutes (lower case). This parameter is Mandatory. |
22.2.3 Example:
This example would return the data observed in the last 10 minutes for Wellington Airport runway sensor G.
GET /aviation/observations/airport/NZWN/sensor/NZWNG/last/10/minutes
22.2.4 API Response:
{
"version":"1.0",
"issue-time":"2019-05-20T00:43:45Z",
"path":"/aviation/observations/airport/NZWN/sensor/NZWNG/last/10/minutes",
"response":[
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:43:20Z",
"met:valid-at":"2019-05-20T00:42:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520004200",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.9",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.8"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:42:22Z",
"met:valid-at":"2019-05-20T00:41:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520004100",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.9",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.8"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:41:22Z",
"met:valid-at":"2019-05-20T00:40:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520004000",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.8",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.7"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:40:22Z",
"met:valid-at":"2019-05-20T00:39:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520003900",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.8",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.7"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:39:21Z",
"met:valid-at":"2019-05-20T00:38:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520003800",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.8",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.7"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:38:21Z",
"met:valid-at":"2019-05-20T00:37:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520003700",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.8",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.7"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:37:21Z",
"met:valid-at":"2019-05-20T00:36:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520003600",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.8",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.7"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:36:21Z",
"met:valid-at":"2019-05-20T00:35:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520003500",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.7",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.6"
}
},
{
"av:runway-sensor-id":"NZWNG",
"av:data-used-in-talpa":"true",
"met:product-name":"runwaysensor",
"met:domain":"aviation",
"met:issue-time":"2019-05-20T00:35:22Z",
"met:valid-at":"2019-05-20T00:34:00Z",
"av:airport-location":"NZWN",
"met:data":{
"stationId":"NZWNG",
"observationTimestamp":"20190520003400",
"stationIdNumeric":"93964",
"roadConditionText01MinAvg":"DRY",
"roadConditionValue01MinAvg":"6",
"roadFriction01MinAvg":"0.82",
"roadFilm01MinAvg":"0.00",
"roadTemp01MinAvg":"21.7",
"roadFilm10MinAvg":"0.00",
"roadTemp10MinAvg":"21.6"
}
}
]
}22.2.5 Table of Airport Codes and associated Sensor Identifiers:
| ICAO Airport Designators | Sensor Identifiers | Description |
|---|---|---|
| NZWN | NZWND | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNE | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNF | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNG | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNH | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNI | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNJ | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNK | Wellington Airport and its Runway Sensor Identifiers |
| NZWN | NZWNL | Wellington Airport and its Runway Sensor Identifiers |